Ingen: A Meta-Modular Plugin Environment 


David Robi I lard 


School of Computer Science 
Carleton University 


Introduction 

Design 

Applications 

The Glorious Future 

•OO 

OO 

OO 

OO 

OOOO 

oooooo 

ooo 


Overview 





Ill M 

Ingen 


► Nobody? Nothing? 

► That company from Jurassic Park? 

► .. . 

► Instrument Generator, “engine” 
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What is Ingen? 


► Ingen is a modular synth, effects processor, mixer, router, 
MIDI processor, cheese grater, chain degreaser.. . 

► .. . a “modular” 

► Designed around LV2 plugins 

► Usable in many different contexts 
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Features 


► Polyphonic 

► Recursive (graphs within graphs) 

► Many data types (including events like MIDI) 

► Strict client/server architecture 

► Real-time editable 

► Flexible deployment 
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Philosophy 


► Do one thing and do it well 

► Integrate with the surrounding environment 

► Make use of existing facilities 
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Existing Facilities? 


► Plugins! 

► Internals Considered Harmful 
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Surrounding Environment 


In the Lignux audio world, there are several choices: 

► JACK application 

► LV2 plugin 

► Network service 

► Physical device (e.g. MOD) 
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Philausophy 


► Do one thing and do it well and do it with real-time safety 

► Keep GUIs at arm's length 
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Terminology 


Ingen contains: 

► Graphs 

► Blocks 

► Ports 

► Arcs 
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Data Model 


Everything is described in a simple data model: 

► All objects have a path, e.g. /amp/gain 

► Objects are a dictionary of properties (key:value) 

► Inherently extensible: keys can be added without breakage 
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Data Model Example 


A snippet of an Ingen graph: 


</osc> 
a 

lv2:prototype 
ingen:canvasX 
ingen:canvasY 


ingen:Block ; 
<urn:someplugin> 
42.0 ; 

24.0 . 
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Protocol 


Ingen is controlled by manipulating the model: 

► Changes are based on property manipulation 

► Everything done with a few generic methods: get, set, put, . .. 

► Vaguely HTTP-like 

► No special "commands” for specific objects 

► No: block.move_to(42, 0) 

► Instead: set block.x = 42, block.y = 0 
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Moving a block on the canvas: 


[ 


] 


a 

patch:subject 
patch:property 
patch:value 


patch:Set ; 
</osc> ; 
ingen:canvasX 
42.0 ; 
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To add, or put, a new block: 

[ 

a patch.:Put ; 

patch:subject </osc> ; 
patch:body [ 

a ingen:Block ; 

lv2:prototype <urn:someplugin> ; 
ingen:canvasX 42.0 ; 
ingen:canvasY 24.0 ; 

] 

] 
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Who Cares? 


► Elegant correspondence between protocol and data model 

► Identical syntax used on the wire and in saved files 

► Conceptually simple 
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► Allows flexible deployment: 

► Ingen as server, network controlled from a different machine 

► Dump text protocol for a plain text log of activity 

► Run Ingen as an LV2 plugin, control via LV2 ports 

► Protocol in binary (LV2 atoms, native float, etc) 

► No shady underhanded communication 

► GUI talks to engine via ports like any LV2 plugin 

► Extensible, properties can be added freely 

► A few methods are capable of everything 
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Scenarios 


► Need to put some non-linear in another host (e.g. Ardour 
mixer strip) 

► Remote-controllable “glue” for a headless JACK box 

► Want to publish a plugin but can't or don't want to code 

► Ingen graphs are LV2 plugins 

► ... literally. No special export, no compilation; the one and 
only save format is LV2 compatible 

► Save to LV2_PATH (typically ~/.lv2) and graphs will be visible 
in any LV2 host 
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rather be doing than what he gets paid to do 




Mundane Improvements 


► Performance / memory consumption improvements 

► Better state/preset support 

► Stability, more rigorous testing 

► GUI polish 
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Whiz-Bang 


► Control panel building (presentation mode) 

► Novel presentation of patching canvas? (Pies?) 

► Integrated online patch repository (MOD?) 

► Dynamic ports when running as LV2 plugin 

► Design plugin suite for message-based programming 

► Make it as simple as possible for users to publish “plugins” 
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